package cn.iocoder.yudao.module.member.address.service;

import cn.iocoder.yudao.framework.validation.groups.UpdateGroup;
import cn.iocoder.yudao.module.member.address.dal.dataobject.MemberAddressDO;
import cn.iocoder.yudao.module.member.address.vo.AppAddressSaveReqVO;
import jakarta.validation.Valid;
import org.springframework.validation.annotation.Validated;

import java.util.List;

/**
 * 用户地址 Service 实现类
 *
 * @author 芋道源码
 */
public interface AddressService {

    /**
     * 创建用户地址
     *
     *
     * @param userId 用户编号
     * @param reqVO 创建信息
     * @return 编号
     */
    Long createAddress(Long userId, @Valid AppAddressSaveReqVO reqVO);

    /**
     * 更新用户地址
     *
     * @param userId 用户编号
     * @param reqVO 更新信息
     */
    void updateAddress(Long userId, @Validated(value = UpdateGroup.class) AppAddressSaveReqVO reqVO);

    /**
     * 删除用户地址
     *
     * @param userId 用户编号
     * @param id 编号
     */
    void deleteAddress(Long userId, Long id);

    /**
     * 清除用户地址，用户注销时用
     *
     * @param userId 用户编号
     */
    void clearAddress(Long userId);

    /**
     * 获得用户地址
     *
     * @param id 编号
     * @return 用户地址
     */
    MemberAddressDO getAddress(Long userId, Long id);

    /**
     * 获得用户地址列表
     *
     * @param userId 用户编号
     * @return 用户地址列表
     */
    List<MemberAddressDO> getAddressList(Long userId);

    /**
     * 获得用户默认地址
     *
     * @param userId 用户编号
     * @return 用户地址
     */
    MemberAddressDO getDefaultAddress(Long userId);

    /**
     * 保存点餐地址
     *
     * @param userId 用户编号
     * @param reqVO 更新信息
     */
    void saveDineAddress(Long userId, @Valid AppAddressSaveReqVO reqVO);

    /**
     * 获得用户点餐地址
     *
     * @param userId 用户编号
     * @return 用户地址
     */
    MemberAddressDO getDineAddress(Long userId);

}
